视频录像|品类_IP摄像机移动应用SDK开发入门教程（安卓版）

篇首语：本文由编程笔记#小编为大家整理，主要介绍了IP 摄像机移动应用 SDK 开发入门教程（安卓版）相关的知识，希望对你有一定的参考价值。

涂鸦智能安卓版摄像机&＃xff08;IP Camera&＃xff0c;简称 IPC&＃xff09;SDK 是基于智能生活 App SDK 开发而成。

通过移动应用控制物理网设备是常见的使用场景&＃xff0c;但由于设备的品类丰富&＃xff0c;增大了应用开发难度。因此 智能生活 App SDK 提供了常见的垂直品类 SDK&＃xff0c;例如 IPC SDK&＃xff0c;将网络摄像机设备特有的功能抽离&＃xff0c;提供了与其通讯的接口封装&＃xff0c;加速应用开发过程。 

大家可以通过本教程&＃xff0c;在一小时内快速开发一款自己的 IoT App&＃xff0c;并实现如下功能&＃xff1a;

•  通过 App 连接一个智能摄像头。
•  预览摄像机实时采集的影像。
•  播放摄像机存储卡中录制的视频。
•  手机端录制摄像机采集的影像。

大家可以 前往App工作台 下载 Sample 查看本教程中的示例代码。本次教程按功能模块进行分类&＃xff0c;大家可以快速找到对应的代码参考学习。

效果展示

学习完本教程&＃xff0c;结合一定的面板开发可以创建一个类似以下安卓 App 的 Demo。

准备工作

在开始本教程前&＃xff0c;请先确保完成一下工作 &＃xff1a;

1. 在涂鸦 IoT 平台&＃xff0c;注册账号并创建 App 应用&＃xff0c;拿到 SDK 的 AppKey&＃xff0c;AppSecret。

   由于 IPC SDK 依赖于 智能生活 App SDK&＃xff0c;需要先实现如创建账号、添加家庭的操作后才能借助 IPC SDK 实现摄像机相关功能。具体操作流程可参考我上一篇文章《智能生活 App SDK 开发入门教程》。

2. 准备一个涂鸦赋能的智能摄像机产品&＃xff0c;本教程以摄像头为例。
3. 使用 android Studio 将涂鸦安卓智能生活 App SDK 集成到项目中 。 具体教程可参考我之前文章《 IPC SDK 架构及快速集成配置》。

设备配网

由涂鸦赋能的智能摄像机支持智能生活 App SDK 中的所有配网方式&＃xff0c;例如 Wi-Fi 热点配网和蓝牙配网等。

此外&＃xff0c;涂鸦为 IPC 设备提供了独有的扫描二维码配网功能&＃xff0c;但如果 IP 摄像机设备无法扫码&＃xff0c;可以优先尝试 Wi-Fi 快连方式。本篇教程文档主要讲解扫描二维码配网。

获取 Token

和 Wi-Fi 快连和 Wi-Fi 热点模式类似&＃xff0c;开始配网之前&＃xff0c;SDK 需要在手机已联网的状态下从涂鸦获取配网 Token&＃xff0c;然后才可以开始配网。

配网 Token 的有效期为 10 分钟&＃xff0c;且配置成功后就会失效&＃xff0c;再次配网需要重新获取。获取 Token 需要上传当前的 homeId&＃xff0c;因此我们需要确保用户处于登录状态&＃xff0c;并至少创建了一个家庭。

TuyaHomeSdk.getActivatorInstance().getActivatorToken(homeId,
new ITuyaActivatorGetToken()
&＃64;Override
public void onSuccess(String token)

&＃64;Override
public void onFailure(String s, String s1)

);


生成配网二维码

获取到配网 Token 后&＃xff0c;我们还需要当前 Wi-Fi 的名称&＃xff08;SSID&＃xff09;和密码&＃xff0c;通过初始化配网参数的回调 onQRCodeSuccess&＃xff0c;拿到二维码的 URL 字符串生成一个二维码图片。

相关依赖为 zxing&＃xff08;implementation ‘com.google.zxing:core:3.2.1’&＃xff09;。

// Get Network Configuration Token
TuyaHomeSdk.getActivatorInstance().getActivatorToken(homeId,
new ITuyaActivatorGetToken()
&＃64;Override
public void onSuccess(String token)
//Create and show qrCode
TuyaCameraActivatorBuilder builder &＃61; new TuyaCameraActivatorBuilder()
.setToken(token)
.setPassword(wifiPwd)
.setTimeOut(100)
.setContext(QrCodeConfigActivity.this)
.setSsid(wifiSSId)
.setListener(new ITuyaSmartCameraActivatorListener()
&＃64;Override
public void onQRCodeSuccess(String qrcodeUrl)
final Bitmap bitmap;
try
bitmap &＃61; QRCodeUtil.createQRCode(qrcodeUrl, 300);
QrCodeConfigActivity.this.runOnUiThread(new Runnable()
&＃64;Override
public void run()
mIvQr.setImageBitmap(bitmap);
mLlInputWifi.setVisibility(View.GONE);
mIvQr.setVisibility(View.VISIBLE);

);
catch (WriterException e)
e.printStackTrace();


&＃64;Override
public void onError(String errorCode, String errorMsg)

&＃64;Override
public void onActiveSuccess(DeviceBean devResp)
Toast.makeText(QrCodeConfigActivity.this,"config success!",Toast.LENGTH_LONG).show();

);



其中生成二维码图片示例代码如下&＃xff1a;

public static Bitmap createQRCode(String url, int widthAndHeight)
throws WriterException
Hashtable hints &＃61; new Hashtable();
hints.put(EncodeHintType.CHARACTER_SET, "utf-8");
hints.put(EncodeHintType.MARGIN,0);
BitMatrix matrix &＃61; new MultiFormatWriter().encode(url,
BarcodeFormat.QR_CODE, widthAndHeight, widthAndHeight, hints);
int width &＃61; matrix.getWidth();
int height &＃61; matrix.getHeight();
int[] pixels &＃61; new int[width * height];
for (int y &＃61; 0; y for (int x &＃61; 0; x if (matrix.get(x, y))
pixels[y * width &＃43; x] &＃61; BLACK; //0xff000000



Bitmap bitmap &＃61; Bitmap.createBitmap(width, height,
Bitmap.Config.ARGB_8888);
bitmap.setPixels(pixels, 0, width, 0, 0, width, height);
return bitmap;



开始配网

开始配网前&＃xff0c;请确保设备处于待配网状态。操作方法可参考设备的使用说明书。

在成功生成二维码后&＃xff0c;引导用户将二维码对准摄像头&＃xff0c;捕捉到二维码信息后会发出提示音。开始配网操作后&＃xff0c;SDK 会持续广播配网信息&＃xff0c;直到配网成功或是超时才停止。

调用 配网接口。目前已经创建好 TuyaCameraActivatorBuilder 对象 builder&＃xff0c;只需进行下面几行代码调用即可。

mTuyaActivator &＃61; TuyaHomeSdk.getActivatorInstance().newCameraDevActivator(builder);
mTuyaActivator.createQRCode();
mTuyaActivator.start();


监听配网结果

在上面构建配网参数时候&＃xff0c;我们通过 TuyaCameraActivatorBuilder 对象 builder 设置监听&＃xff0c;通过 ITuyaSmartCameraActivatorListener 回调监听配网结果。

public interface ITuyaSmartCameraActivatorListener
void onQRCodeSuccess(String qrcodeUrl);
void onError(String errorCode, String errorMsg);
void onActiveSuccess(DeviceBean devResp);


停止配网 

如果需要中途取消配网&＃xff0c;如离开配网页面&＃xff0c;或配网完成&＃xff0c;请调【停止配网】接口。

mTuyaActivator.stop();


视频实时预览&＃xff08;视频直播&＃xff09;

IPC SDK 提供智能摄像机的实时视频播放、设备存储卡录像播放、对当前正在播放的视频截图、录制视频、与摄像机实时通话等基础能力。

第一步&＃xff1a;初始化

我们需要首先初始化一个 ITuyaSmartCameraP2P 对象。该对象用于读取智能摄像机设备的相关属性和方法。

TuyaCameraView 是 IPC SDK 提供的视频渲染视图&＃xff0c;通过它可以快速的搭建渲染出视频预览画面。

// 1. 创建 ITuyaSmartCameraP2P
ITuyaSmartCameraP2P mCameraP2P &＃61; null;
ITuyaIPCCore cameraInstance &＃61; TuyaIPCSdk.getCameraInstance();
if (cameraInstance !&＃61; null)
mCameraP2P &＃61; cameraInstance.createCameraP2P(devId));
TuyaCameraView mVideoView &＃61; findViewById(R.id.camera_video_view);
// 2. 为渲染视图容器设置回调
mVideoView.setViewCallback(new AbsVideoViewCallback()
&＃64;Override
public void onCreated(Object view)
super.onCreated(view);
//4. 渲染视图构造完成时&＃xff0c;为 ITuyaSmartCameraP2P 绑定渲染视图
if (null !&＃61; mCameraP2P)
mCameraP2P.generateCameraView(view);


);
// 3. 构造渲染视图
mVideoView.createVideoView(p2pType);
// 4. 注册 P2P 监听
if (null !&＃61; mCameraP2P)
mCameraP2P.registerP2PCameraListener(new AbsP2pCameraListener()
&＃64;Override
public void onSessionStatusChanged(Object camera, int sessionId, int sessionStatus)
super.onSessionStatusChanged(o, i, i1);

);


第二步&＃xff1a;连接 P2P 通道

一系列初始化动作完成后&＃xff0c;需要先连接 P2P 通道。P2P 的连接状态需要我们自行维护。

开始连接 P2P 通道&＃xff0c;参数 mode 可以指定优先选择的连接模式&＃xff0c;是通过局域网还是公网来连接。如果指定局域网连接优先&＃xff0c;但是 App 和设备没有在同一个局域网内建立 TCP 连接&＃xff0c;或者设备不支持局域网连接优先&＃xff0c;SDK 会自动使用公网连接模式。

• 建立指定通道

  void connect(String devId, int mode, OperationDelegateCallBack callBack);


• 断开通道

  在关闭通道或离开当前页面时&＃xff0c;我们需要调用接口关闭通道。

  void disconnect(String devId, OperationDelegateCallBack callBack);


• 状态监听

  若需要在过程中监听通道的连接和断开&＃xff0c;可通过 OperationDelegateCallBack 来实现监听。

  mCameraP2P.connect(devId, new OperationDelegateCallBack()
&＃64;Override
public void onSuccess(int sessionId, int requestId, String data)
//连接成功

&＃64;Override
public void onFailure(int sessionId, int requestId, int errCode)
//连接失败

);


第三步&＃xff1a;预览实时视频

在建立 P2P 通道后&＃xff0c;用户就可以预览在线视频了。

• 开始预览

  以下代码中&＃xff0c;clarity 是清晰度模式&＃xff0c;2 代表标清、4 代表高清。

  void startPreview(int clarity, OperationDelegateCallBack callBack);


• 结束预览

  int stopPreview(OperationDelegateCallBack callBack);


• 状态监听

  实现如下代码可以监听视频开始预览的状态变化&＃xff0c;stopPreview 同理。

  mCameraP2P.startPreview(new OperationDelegateCallBack()
&＃64;Override
public void onSuccess(int sessionId, int requestId, String data)
//开始播放实时视频成功

&＃64;Override
public void onFailure(int sessionId, int requestId, int errCode)
//开始播放实时视频失败

);


第四步&＃xff1a;注销进程

不再使用摄像机视频功能的时候&＃xff0c;请务必注销 P2P 监听器和删除 P2P 对象。

&＃64;Override
public void onDestroy()
if (null !&＃61; mCameraP2P)
mCameraP2P.removeOnP2PCameraListener();
mCameraP2P.destroyP2P();



视频录制与实时对讲

在预览实时视频的同时&＃xff0c;还可以对录制在线视频或通过摄像机实时对讲。

• 开始录制或对讲

  int startRecordLocalMp4(String folderPath, Context context, OperationDelegateCallBack callBack);
void startAudioTalk(OperationDelegateCallBack callBack);


• 结束录制/对讲

  int stopRecordLocalMp4(OperationDelegateCallBack callBack);
void stopAudioTalk(OperationDelegateCallBack callBack);


• 监听状态

  我们可以通过监听回调事件 OperationDelegateCallBack 来监听录制和实时对讲的状态。

  public interface OperationDelegateCallBack
void onSuccess(int sessionId, int requestId, String data);
void onFailure(int sessionId, int requestId, String data);


回放历史视频

设备在存储卡中保存视频录像后&＃xff0c;可以通过 IPC SDK 在 App 端播放视频录像。

和视频预览一样&＃xff0c;在开始回放前&＃xff0c;需要先连接上 P2P 通道。

IPC SDK 支持以天为单位查看和播放视频录像&＃xff0c;并且提供查询某年某月中&＃xff0c;哪几天保存有视频录像&＃xff0c;以便于用户查看&＃xff0c;查询结果通过 OperationDelegateCallBack 监听回调返回。

查询视频列表

创建 ITuyaSmartCameraP2P 对象&＃xff0c;连接上 P2P 通道。P2P 通道连接成功后&＃xff0c;可以获取到设备端存储卡中录制的视频片段时间信息。

第一步&＃xff1a;查询特定月份保存过视频的日期

int year &＃61; Integer.parseInt(substring[0]);
int mouth &＃61; Integer.parseInt(substring[1]);
queryDay &＃61; Integer.parseInt(substring[2]);
mCameraP2P.queryRecordDaysByMonth(year, mouth, new OperationDelegateCallBack()
&＃64;Override
public void onSuccess(int sessionId, int requestId, String data)
//data 是获取到的月份数据
MonthDays monthDays &＃61; JSONObject.parseObject(data, MonthDays.class);
mBackDataMonthCache.put(mCameraP2P.getMonthKey(), monthDays.getDataDays());
mHandler.sendMessage(MessageUtil.getMessage(MSG_DATA_DATE, ARG1_OPERATE_SUCCESS, data));

&＃64;Override
public void onFailure(int sessionId, int requestId, int errCode)
mHandler.sendMessage(MessageUtil.getMessage(MSG_DATA_DATE, ARG1_OPERATE_FAIL));

);


第二步&＃xff1a;获取特定日期的视频列表

我们可以根据上一步返回的日期查询当天的视频信息列表。

int year &＃61; Integer.parseInt(substring[0]);
int mouth &＃61; Integer.parseInt(substring[1]);
int day &＃61; Integer.parseInt(substring[2]);
mCameraP2P.queryRecordTimeSliceByDay(year, mouth, day, new OperationDelegateCallBack()
&＃64;Override
public void onSuccess(int sessionId, int requestId, String data)
//data 是获取到指定日期的视频片段数据
parsePlaybackData(data);

&＃64;Override
public void onFailure(int sessionId, int requestId, int errCode)
mHandler.sendEmptyMessage(MSG_DATA_DATE_BY_DAY_FAIL);

);


private void parsePlaybackData(Object obj)
RecordInfoBean recordInfoBean &＃61; JSONObject.parseObject(obj.toString(), RecordInfoBean.class);
if (recordInfoBean.getCount() !&＃61; 0)
List timePieceBeanList &＃61; recordInfoBean.getItems();
if (timePieceBeanList !&＃61; null && timePieceBeanList.size() !&＃61; 0)
mBackDataDayCache.put(mCameraP2P.getDayKey(), timePieceBeanList);

mHandler.sendMessage(MessageUtil.getMessage(MSG_DATA_DATE_BY_DAY_SUCC, ARG1_OPERATE_SUCCESS));
else
mHandler.sendMessage(MessageUtil.getMessage(MSG_DATA_DATE_BY_DAY_FAIL, ARG1_OPERATE_FAIL));




以上代码涉及了以下 2 个实体对象类&＃xff1a;

• RecordInfoBean 数据模型&＃xff1a;

  
  

  参数	说明
  count	片段个数
  List	视频片段集合

• TimePieceBean 数据模型&＃xff1a;

  
  

  参数	说明
  startTime	视频片段开始时间
  endTime	视频片段结束时间
  playTime	视频片段播放时间

完成以上步骤&＃xff0c;我们就可以获取到有回放的视频片段。

播放视频

成功查询到某天中的视频录像片段后&＃xff0c;就可以开始播放录像视频了。

• 开始播放

  mCameraP2P.startPlayBack(timePieceBean.getStartTime(),
timePieceBean.getEndTime(),
timePieceBean.getStartTime(), new OperationDelegateCallBack()
&＃64;Override
public void onSuccess(int sessionId, int requestId, String data)
isPlayback &＃61; true;

&＃64;Override
public void onFailure(int sessionId, int requestId, int errCode)
isPlayback &＃61; false;

, new OperationDelegateCallBack()
&＃64;Override
public void onSuccess(int sessionId, int requestId, String data)
isPlayback &＃61; false;

&＃64;Override
public void onFailure(int sessionId, int requestId, int errCode)
isPlayback &＃61; false;

);


  该方法的三个参数均为时间戳&＃xff1a;

  
  
  • PlayTime 为播放的初始帧时间&＃xff0c;可以与 startTime 设置为同一值。
  • StartTime 为播放的开始时间&＃xff0c;为 TimePieceBean 数据模型中 startTime 相对应的值。
  • EndTime 为播放的结束时间&＃xff0c;为 TimePieceBean ​​​​​​​数据模型中 endTime 相对应的值。

• 暂停回放

  void pausePlayBack(OperationDelegateCallBack callBack);


• 继续回放

  void resumePlayBack(OperationDelegateCallBack callBack);


• 停止回放

  void stopPlayBack(OperationDelegateCallBack callBack);


• 监听回调(OperationDelegateCallBack)

  public interface OperationDelegateCallBack
void onSuccess(int sessionId, int requestId, String data);
void onFailure(int sessionId, int requestId, String data);


  

相关概念

涂鸦智能摄像机的视频录像分为 连续录像 和 事件录像。

• 连续录像&＃xff1a;视频录像会是 10 分钟一个片段&＃xff0c;且所有视频片段是连续的&＃xff0c;但是如果中间有停止过视频录像&＃xff0c;那么连续录像模式下的视频片段间也可能会有间隔。

  如果某天的视频录像片段是连续的&＃xff0c;那么播放录像时&＃xff0c;会自动播放下一段。也就是说&＃xff0c;即使调用开始播放接口&＃xff0c;传入的是当天第一个视频片段的时间点&＃xff0c;视频也会一直播放到当天最后一个视频片段的最后一帧视频&＃xff0c;才会回调视频播放结束的代理方法。

• 事件录像&＃xff1a;每个录像片段长度不等&＃xff0c;且片段间的间隔时间也长短不一。

  如果某天的视频录像片段是不连续的&＃xff0c;即视频录像片段 A 结束后隔了一段时间才有视频录像片段 B&＃xff0c;在播放到断开的地方&＃xff08;即播放到视频片段 A 的最后一帧&＃xff09;&＃xff0c;视频流会自动停止。

下一步

IPC SDK 还提供了更多功能&＃xff0c;大家可以登录涂鸦 IoT 开发平台​​​​​​​&＃xff0c;根据 Sample 工程和 IPC SDK 文档了解如何构建 App。